home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / cubemenu / cubemenu.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  8.3 KB  |  184 lines  |  [TEXT/ttxt]
  1.  
  2.           Cube Menu - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4.  
  5. This applet is a modified version of TmapCube that can work as a selector
  6. menu, where each face of a cube is a selectable link. This applet is fully
  7. parametrized, so you can change the size and movements of the cube.
  8.  
  9. This feature works only when you register the applet and receive a unique
  10. code.
  11.  
  12. ******************************************************************
  13.  
  14. NECESSARY FILES.
  15.  
  16. As well as image files for the faces and optional background and/or 
  17. foreground images, the following 3 ".class" files must be uploaded: 
  18.  
  19. CubeMenu.class
  20. Lware.class
  21. anfy.class
  22.  
  23. Plus, CubeMenu.jar for speedy loading on recent browsers.
  24.  
  25. *******************************************************************
  26.  
  27. EXAMPLE
  28.  
  29. Insert the <applet> tag in your html document as follows to add this applet
  30. to your page (Comments after the ";" symbol are code explanations and
  31. acceptable min/max values. They are not part of the applet language):
  32.  
  33. <applet archive="CubeMenu.jar" code="CubeMenu.class" width="180" height="180">
  34. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  35. <param name="regcode" value="NO">         ; Registration code (if you have it)
  36. <param name="regnewframe" value="YES">    ; Reglink opened in new frame?
  37. <param name="regframename" value="_blank">; Name of new frame for reglink
  38. <param name="res" value="1">              ; Resolution (1 .. 8)
  39. <param name="image1" value="face1.gif">   ; Image 1 to load
  40. <param name="image2" value="face1.jpg">   ; Image 2 to load
  41. <param name="image3" value="face2.gif">   ; Image 3 to load
  42. <param name="image4" value="face2.jpg">   ; Image 4 to load
  43. <param name="image5" value="face3.jpg">   ; Image 5 to load
  44. <param name="image6" value="face3.jpg">   ; Image 6 to load
  45. <param name="link1" value="http://www.yahoo.com">    ; Link for face 1
  46. <param name="link2" value="http://www.yahoo.com">    ; Link for face 2
  47. <param name="link3" value="http://www.eff.org">      ; Link for face 3
  48. <param name="link4" value="http://www.eff.org">      ; Link for face 4
  49. <param name="link5" value="http://www.anfyteam.com"> ; Link for face 5
  50. <param name="link6" value="http://www.anfyteam.com"> ; Link for face 6
  51. <param name="statusmsg1" value="site 1">     ; Statusbar message for face 1
  52. <param name="statusmsg2" value="site 1">     ; Statusbar message for face 2
  53. <param name="statusmsg3" value="site 2">     ; Statusbar message for face 3
  54. <param name="statusmsg4" value="site 2">     ; Statusbar message for face 4
  55. <param name="statusmsg5" value="site 3">     ; Statusbar message for face 5
  56. <param name="statusmsg6" value="site 3">     ; Statusbar message for face 6
  57. <param name="rotx" value="4">                ; X Rotation speed
  58. <param name="roty" value="6">                ; Y Rotation speed
  59. <param name="rotz" value="8">                ; Z Rotation speed
  60. <param name="backimage" value="NO">          ; Optional background image
  61. <param name="backr" value="64">              ; Red in background (0 .. 255)
  62. <param name="backg" value="96">              ; Green in background (0 .. 255)
  63. <param name="backb" value="160">             ; Blue in background (0 .. 255)
  64. <param name="clearback" value="YES">       ; Clear the background ("YES" - "NO")
  65. <param name="floatmode" value="NO">       ; Float mode ("YES" or "NO")
  66. <param name="floatw" value="200">         ; Float window width
  67. <param name="floath" value="280">         ; Float window height
  68. <param name="floatx" value="100">         ; Float window x position start
  69. <param name="floaty" value="100">         ; Float window y position start
  70. <param name="floatitle" value="Cube Menu"> ; Float window title
  71. <param name="floatinfront" value="NO">    ; Float win. always on top (YES,NO)
  72. <param name="overimg" value="NO">          ; Optional image over applet
  73. <param name="overimgX" value="0">          ; Over image X offset
  74. <param name="overimgY" value="0">          ; Over image Y offset
  75. <param name="memdelay" value="1000">       ; Memory deallocation delay
  76. <param name="priorityL" value="3">         ; Loading task priority (1..10)
  77. <param name="priority" value="3">          ; Task priority (1..10)
  78. <param name="MinSYNC" value="10">          ; Min. milliseconds/frame for sync
  79. Sorry, your browser doesn't support Java.; Message for no java browsers.
  80. </applet>                                ; End of applet tag
  81.  
  82. ********************************************************************
  83.                    
  84. INSTRUCTIONS.
  85.  
  86. The following instructions describe how to change parameters:
  87.  
  88. Attempting to change the credit parameter will disable the applet.
  89.  
  90. To activate the reg parameters read the shareware registration notes.
  91. In the "regcode" parameter, place the registration code you purchased
  92.  from the author. If the code is correct and the applet is run from the
  93.  registered domain name, you can use "link" parameters to link to a URL
  94. when the applet is "clicked".
  95.  
  96. If you set "regnewframe" to "YES", you can specify a specific frame location
  97. for the reglink:
  98.  
  99. "_blank"  : To load the link in a new blank unnamed browser window.
  100. "_self"   : To load the link into the same window the applet occupies.
  101. "_parent" : To load the link into the immediate FRAMESET parent.
  102. "_top"    : To load the link into the top body of the window.
  103.  
  104. You can also set a custom frame name, such as "myframe1".
  105.  
  106. With the "overimg" parameter you can specify the name of an image that will
  107. be painted over the applet. The best options are transparent GIF images.
  108.  
  109. NOTE: Animated GIF images are supported, but will be animated only on latest
  110.  browsers (Netscape 4 and Explorer 4 or newer).
  111.  
  112. With "overimgX" and "overimgY" you can center the image over the applet area.
  113.  
  114. This applet CAN'T WORK AS A MENU without a registration code.
  115.  
  116. You can load up to 6 different images to map on the faces of a cube.
  117. If you place the same image name on all 6 image parameters, all faces will
  118. display the same image. Otherwise you can display 2, 3, 4, 5, or 6 different
  119. images. The best choices are 3 and 6, because with 3 different images
  120. placed in the same order of the example above, you will see no duplicate
  121. images in the same frame.
  122.  
  123. Filling all the faces of the cube with 6 different images can be done,
  124. but loading time will increase.
  125.  
  126. The GIF/JPG images MUST all be 256*256 pixels OR all be 128 X 128 pixels in
  127. size. No other sizes are allowed, and you can't mix 128*128 images with
  128. 256*256 images in the same cube applet.  
  129.  
  130. NOTE:
  131.  
  132. Using 256*256 images is useful only when the applet size is greater than 150.
  133.  
  134. You can mix GIF and JPG formats in the same cube but not the image size.
  135.  
  136. "Res" is a sort of zoomer. Res=1 is normal size, res=2 is double size, etc.
  137. Remember to multiply "width" and "height" tags to coincide the value for "res".
  138.  If this is 1, the multiplication is unnecessary. 
  139.  
  140. With the "rotx", "roty" and "rotz" parameters you can control the rotation
  141. speed of the cube.
  142.  
  143. With "backr", "backg" and "backb" parameters you can control the RED, GREEN
  144. and BLUE components of the background colour.
  145.  
  146. You can optionally load a background image, placing its name on the
  147. "backimage" parameter. This image must be the same size as the applet if
  148. res=1. If it is res=2, it must be half the size of the applet, and so on.
  149.  
  150. You can disable the background clear routine by setting "NO" to "clearback"
  151. parameter.
  152.  
  153.  
  154. *****
  155.  
  156. The floating mode:
  157.  
  158. Optionally, you can enable the "floating window" mode.
  159. The treemenu applet, then, will appear in a floating external window, and will
  160. leave free all the other frame space on the web site.
  161. But, you still have to create a small horizontal or vertical frame (maybe
  162. 1 or 2 pixels large), containing the applet, 1 pixel large.
  163.  
  164. To enable this mode:
  165.  
  166. 1) Set "floatmode" to "YES"
  167. 2) Copy the applet width in the "floatw" parameter
  168. 3) Copy the applet height in the "floath" parameter
  169. 4) Set the applet width=1 and height=1
  170.  
  171. At this point, you just have to customize it using those parameters:
  172.  
  173. The window title must be written in the "floatitle" parameter.
  174.  
  175. The starting X and Y position where window should apper, must be written
  176. in the "floatx" and "floaty" parameters. Note: the coordinates are relative
  177. to user screen, so result can change depending on screen resolution.
  178.  
  179. If you want the window to be always on top and visible, set the "floatinfront"
  180. parameter to "YES". This could be useful for someone, and annoying for others.
  181.  
  182. Note: the "floatinfront" option will have no effect on some versions of
  183. Internet Explorer.
  184.